home *** CD-ROM | disk | FTP | other *** search
/ CD School House 9 / CD School House 9.0 - Wayzata Technology (1994).iso / pc / dos / teachaid / pccai / caiarc1.exe / CREATE.CAI < prev    next >
Text File  |  1993-12-06  |  17KB  |  653 lines

  1. .rem
  2. .rem -----------------PRESS CTRL-G (Go) TO RUN THIS PROGRAM---------
  3. .rem
  4. @OPTION ESCAPE:THATSALL
  5. .screen 0
  6. .cls
  7. .skip 6
  8. .color 11
  9. .cen (*How to Use the PC-CAI Program Generator-CREATE*)
  10.  
  11.  
  12. .cen(*(C)Copyright Alan C. Elliott, 1986-93*)
  13. .skip 4
  14. .pau (*Please press ENTER*)
  15. .cls
  16. .col 12
  17. .cen(*A BASIC UNDERSTANDING*)
  18. .skip 3
  19. .color 3
  20. The PC-CAI Program Generator, called CREATE, is very simple to use. However,
  21. you must have a basic understanding about how a PC-CAI tutorial is set up.
  22. With CREATE, you can create a tutorial such as the one you are now using.
  23. Once you have progressed, you may skip using CREATE at all, and create your
  24. own PC-CAI program using a text editor, which is provided with PC-CAI.
  25. .skip 3
  26. Let's discover the basic structure of a PC-CAI tutorial.
  27. .skip 3
  28. .color 10
  29. .pau (*Please press ENTER*)
  30. .cls
  31.                            ┌──────────────┐
  32.                            │     TITLE    │
  33.                            └──────────────┘
  34.                                   
  35.                            ┌──────────────┐
  36.                            │   TUTORIAL   │
  37.                            │     TEXT     │
  38.                            └──────────────┘
  39. .col 3
  40. .loc 16,1
  41. A tutorial usually begins with a title. After a TITLE is given, there will
  42. generally be some tutorial text, such as an explanation of what is coming up,
  43. or a teaching session. This text may precede a "Question" session, and is
  44. displayed for the student generally once.
  45.  
  46. .pau (*Please press ENTER*)
  47. .loc 14,1
  48. .bla 8
  49. .loc 5,1
  50. .col 12
  51.                            ┌──────────────┐
  52.                            │   TUTORIAL   │
  53.                        |-->│     TEXT     │
  54.                        |   └──────────────┘
  55.                        |<-------    ----------> STOP
  56.                            ┌───────────────┐
  57.                            │ Q & A Session │
  58.                            └───────────────┘
  59. .loc 16,1
  60. .col 3
  61. Following tutorial text, the program may
  62.  
  63. .col 11
  64.         STOP ─ GO TO ANOTHER TEXT SECTION ─ OR BEGIN A QUESTION SECTION
  65.  
  66. .col 3
  67. For each question in the tutorial, the program must know what are the right
  68. and (sometimes) the wrong answers.
  69.  
  70. .pau (*Please press ENTER*)
  71. .loc 16,1
  72. .bla 8
  73. .loc 13,1
  74. .col 11
  75.                                   
  76.                            ┌───────────────┐
  77.                            │   ANSWER IS   │
  78.                            │   EVALUATED   │
  79.                            └───────────────┘
  80. .loc 18,1
  81. .bla 6
  82. .loc 18,1
  83. .col 3
  84. After the question is asked and an answer is entered by the student, the
  85. program checks to determine if the answer is right or wrong.
  86.  
  87. .pau (*Please press ENTER*)
  88. .col 11
  89. .loc 15,45 (*---*)
  90. .loc 14,47 (*|*)
  91. .loc 13,47 (*|*)
  92. .loc 12,47 (*|*)
  93. .loc 11,45 (*<--*)
  94. .loc 12,50 (*Loop according to*)
  95. .loc 13,50 (*number of tries*)
  96. .loc 14,50 (*allowed.*)
  97. .loc 18,1
  98. .bla 6
  99. .loc 18,1
  100. .col 3
  101. If the answer given is wrong, the question may be asked again. The author
  102. of the program specifies how many tries the student will have.
  103.  
  104. .pau (*Please press ENTER*)
  105. .loc 18,1
  106. .bla 5
  107. .col 11
  108. .loc 18,1
  109.                                   
  110.                <----Continue------or-------Stop------->
  111.  
  112. .loc 18,16 (*|*)
  113. .loc 17,16 (*|*)
  114. .loc 16,16 (*|*)
  115. .loc 15,16 (*|*)
  116. .loc 14,16 (*|*)
  117. .loc 13,16 (*|*)
  118. .loc 12,16 (*|*)
  119. .loc 11,16 (*|---------->*)
  120. .loc 10,16 (*|*)
  121. .loc 9,16 (*|*)
  122. .loc 8,16 (*|*)
  123. .loc 7,16 (*------->*)
  124. .loc 21,1
  125. .col 3
  126. If the question is answered correctly, or if the number of tries is exhausted,
  127. the tutorial may (1) STOP, (2) Begin another question, or (3) Enter another
  128. Tutorial Text section, concluding the cycle.
  129. .pau (*Please press ENTER*)
  130. .cls
  131. .col 11
  132. .skip 2
  133. .cen (*CREATE*)
  134. .col 3
  135.  
  136. That is a brief look at a typical tutorial. The CREATE program can help you
  137. create tutorials like the one outlined above.
  138. .skip 4
  139. .col 12
  140. WHAT IS THE CREATE PROGRAM?
  141.  
  142. .col 3
  143.  
  144. CREATE is the AUTHORING SYSTEM program of the PC-CAI Development System. It
  145. asks the tutorial author a series of questions, and from the author's answers,
  146. the program CREATE creates a PC-CAI program (stored in a computer file), which
  147. can then be run.
  148.  
  149. .pau (*Please Press ENTER*)
  150. .cls
  151. .col 12
  152.                               The Flow of Creation
  153.                                A Typical Scenario
  154.  
  155. .col 3
  156.           ONE                   TWO                     THREE
  157.     ________________      __________________      ___________________
  158.     In the beginning      Second, the author      Third, the PC-CAI run
  159.     the tutorial          uses the editor to      module is started,
  160.     author runs the       correct any typos       and the tutorial is
  161.     CREATE program.       or to make minor        tested. If corrections
  162.                           changes.                need to be made, go back
  163.                                                   to the second step.
  164. .col 10
  165.  
  166.        RESULT               RESULT                   RESULT
  167.  
  168.  
  169.     A PC-CAI tutorial    The PC-CAI tutorial        A finished product.
  170.     is stored in a       file is updated
  171.     computer file.       with corrections.
  172. .col 3
  173.  
  174. .pau (*Please press ENTER*)
  175. .cls
  176. .col 12
  177.                 TWO MAJOR PROGRAMS USED IN THE CREATION PROCESS
  178. .col 3
  179.  
  180. There are three major programs used in the creation process.
  181.  
  182. 1. CREATE - The authoring program
  183. 2. CAI    - The "run module", which interprets the tutorial program,
  184.             and causes it to do what the author has instructed.
  185. 3. CAIEDIT- Optionally you may also use the CAIEDIT editor module to edit
  186.             the program.
  187.  
  188. There is a forth important program called CAI-UTIL that contains support
  189. routines including the IMAGE maker, used for animation and program setup.
  190.  
  191.  
  192. @begin
  193. .col 3
  194. Please enter the name of the program which creates a tutorial by asking the
  195. author questions about the contents of the tutorial.
  196. .col 12
  197.  
  198. @read(*Enter the name here :*)
  199. @right (*CREATE*) force nocase
  200. .col 10
  201.  
  202. VERY GOOD!
  203. .play (*mfo2l16cdefgabo3c*)
  204. @end
  205.  
  206. .pau (*Please press ENTER*)
  207. .loc 9,1
  208. .bla 14
  209. .loc 11,1
  210. @begin
  211. .col 3
  212. Please enter the name of the program which runs the created tutorial.
  213. .col 12
  214.  
  215. @read(*Enter the name here :*)
  216. @right (*CAI*) force nocase
  217. .col 10
  218.  
  219. VERY GOOD!
  220. .play (*mfo2l16cdefgabo3c*)
  221. @end
  222.  
  223. .pau (*Please press ENTER*)
  224. .loc 11,1
  225. .bla 11
  226. .loc 11,1
  227. @begin
  228. .col 3
  229. Please enter the name of the program that contains the PC-CAI editor.
  230. .col 12
  231.  
  232. @read(*Enter the name here :*)
  233. @right (*CAIEDIT*) force nocase
  234. .col 10
  235.  
  236. VERY GOOD!
  237. .play (*mfo2l16cdefgabo3c*)
  238. @end
  239.  
  240. .pau (*Please press ENTER*)
  241. .cls
  242. .col 12
  243.                           BEGINNING THE CREATE PROGRAM
  244.  
  245. .col 3
  246. .skip 3
  247. To begin the CREATE tutorial, you must have the PC-CAI Development System
  248. Diskette in Drive A (or on hard disk drive C) and the "A>" or "C:\>" prompt
  249. must be on the screen. The command to begin the program is simply
  250.  
  251. C:\>CREATE
  252. .col 12
  253.  
  254. You try it...enter the command to begin the CREATE program:
  255. .col 7
  256.  
  257.  
  258. @begin
  259. @tries 99
  260. @READ(*C:\>*)
  261. @RIGHT (*CREATE*) Exact nocase
  262. .col 10
  263.  
  264. VERY GOOD!
  265. .play (*mfo2l16cdefgabo3c*)
  266.  
  267. .pau (*Please press ENTER*)
  268. @wrong
  269.  
  270. Be careful in typing in the name of the CREATE program.
  271.  
  272. .pau (*Please press Enter*)
  273. .loc 11,1
  274. .bla 11
  275. .loc 12,1
  276. @end
  277. .cls
  278. .col 3
  279.  
  280. Once the CREATE program begins, you are presented with a list of tutorial
  281. types to choose from. These types define the general "look" of a tutorial.
  282. Later, we will learn how you can create your own custom tutorial types.
  283.  
  284. ┌──────────────────────────────────────────────────────────────────────┐
  285. │1. Test:One right answer (Exact Nocase), one chance, reply            │
  286. │2. Test:One right answer (Keyword), one chance, no replies            │
  287. │3. Allow full flexibility in the design of tutorial.                  │
  288. │4. Define your own tutorial type.                                     │
  289. └──────────────────────────────────────────────────────────────────────┘
  290.  
  291. .col 12
  292. The Most Flexible
  293.  
  294. .col 3
  295. The most flexible tutorial type causes the CREATE program to ask the tutorial
  296. author the maximum number of questions. You will often want to use a more
  297. restricted tutorial type to avoid answering questions unnecessary for the
  298. particular tutorial you may be creating.
  299.  
  300. .pau (*Please press ENTER*)
  301. .cls
  302. .COL 10
  303.                              Synopsis of a tutorial
  304.  
  305. .col 3
  306.  
  307. 1. The Title Screen
  308.  
  309. 2. Textual Information
  310.  
  311. 3. Question(s)
  312.  
  313. 4. Ending
  314.  
  315.  
  316. Parts 1 and 4 occur only once, and parts 2 and 3 may occur many times.
  317.  
  318.  
  319. .pau (*Please press Enter*)
  320. .cls
  321. .cen(*Entering Text in CREATE*)
  322.  
  323. In each of the parts of CREATE where you enter textual information, the same
  324. procedure is used.
  325.  
  326. 1. The prompt ">" will always appear at the far left side of the screen.
  327.  
  328. 2. As you type information on the screen, a "word wrap" will occur when the
  329. typing reaches the right edge of the screen, so that you need not press the
  330. enter key as you type. Pressing the Esc key ends the entry.
  331.  
  332. 3. To backup and correct an entry on the same line, use the <-- key next to
  333. the = key.
  334.  
  335. 4. To backup an entire line, enter a .B after the > prompt.
  336.  
  337. 5. To end a section without saving it (abort) enter a .A after the > prompt.
  338.  
  339. 6. It will often be advisable to put off correcting mistakes as you are
  340. entering textual material, and to correct those mistakes in the Editor.
  341.  
  342. .pau (*Please press ENTER*)
  343. .cls
  344.                                      REVIEW
  345.  
  346.  
  347. @Beg
  348. @tri 4
  349.  
  350. In order to backup a line to make a correction, what command is entered after
  351. the > prompt?
  352.  
  353. @READ(*Enter your answer here     >*)
  354. @RIGHT(*.B*)exact nocase
  355.  
  356. Correct! Also remember that the command is abort a section is
  357. .play (*o2mbl16cdefgabo3c*)
  358.  
  359. >.A
  360.  
  361. .pau (*Please press Enter*)
  362. @Wrong
  363.  
  364. The backup command at the > prompt is a dot (.) plus a B.
  365.  
  366. .pau (*Please press Enter*)
  367. .loc 4,1
  368. .bla 18
  369. .loc 4,1
  370. @wrong Final
  371.  
  372. The answer is   >.B
  373. @end
  374. @beg
  375. @tries 4
  376. .col 3
  377. .cls
  378.  
  379. Here is a typical situation: You have typed this textual material, and then
  380. notice that the name Washington is misspelled...
  381.  
  382. >George Washington was the first President of the United States. He is
  383. >remembered for his brilliant role commanding the Continental Army during the
  384. >American Revolution, and his wooden teeth.
  385. >
  386.  
  387. What should you do to correct the misspelling?
  388.  
  389. 1) Enter .B three times, and re-enter the sentence.
  390. 2) Enter .A to abort the section, and begin again.
  391. 3) Wait and correct it using the PC-CAI editor.
  392.  
  393. @READ(*Enter the number of your answer here :*)
  394. @RIGHT(*3*) exact
  395.  
  396. Correct, that is the best choice. To correct minor (or major) mistakes, the
  397. PC-CAI editor will do the fastest, easiest job.
  398.  
  399. .play (*o2mbl16cdefgabo3c*)
  400.  
  401. @Wrong (*2*) exact
  402.  
  403. That is a possible choice, but not the best.
  404.  
  405. .pau (*Please press ENTER*)
  406. @Wrong (*1*) exact
  407.  
  408. That is a possible choice, but not the best.
  409.  
  410. .pau (*Please press ENTER*)
  411. @end
  412.  
  413. .pau (*Please press Enter*)
  414. @beg
  415. @tries 4
  416. .cls
  417.  
  418. Once you are satisfied that the entry is acceptable, which key will you press?
  419.  
  420.  
  421. 1) Esc key
  422. 2) Enter Key
  423. 3) Break Key
  424.  
  425. @Read (Enter your answer here >*)
  426. @Right(*1*) exact
  427.  
  428. Very Good!
  429. .play (*o2mbl16cdefgabo3c*)
  430.  
  431. @Wrong
  432.  
  433. No, the proper key to press is the escape key (Esc), located at the upper
  434. left of the keyboard.
  435.  
  436. .pau (*Please press Enter*)
  437. @end
  438.  
  439. .pau (*Please press ENTER*)
  440. .cls
  441.                             TYPES OF ANSWER MATCHES
  442.  
  443.  
  444. During the course of creating a tutorial, or in the process of defining a
  445. tutorial, you will need to specify what KIND of match to expect the user to
  446. give to a question. This instructs the PC-CAI program how to MATCH the answer
  447. the user gives to the answer that you have indicated as the correct answer.
  448.  
  449. .col 12
  450. TYPES OF MATCHES
  451.  
  452. .col 3
  453.  
  454. KEYWORD
  455.         EXACT
  456.               EXACT NOCASE
  457.                           SOUNDEX
  458.                                  DECIMAL
  459.                                         LIST
  460.                                              FORCE
  461.                                                    FORCE NOCASE
  462.  
  463. .pau (*Please press Enter*)
  464. .cls
  465. .col 12
  466. THE KEYWORD MATCH
  467.  
  468. .col 3
  469. KEYWORD matches answers by testing to see if the designated answer is
  470. CONTAINED in the user's answer (ignoring case). For instance,
  471.  
  472. The designated answer is WASHINGTON.
  473.  
  474. The user answers George Washington.
  475.  
  476. The word WASHINGTON is contained in the answer George Washington, therefore,
  477. it is a match.
  478.  
  479. You must be careful with the keyword match since "John Washington" and
  480. "Washington DC" would both also match the designated answer.
  481.  
  482.  
  483. .pau (*Please press Enter*)
  484. .cls
  485. .col 12
  486.                              EXACT and EXACT NOCASE
  487. .col 3
  488.  
  489. EXACT matches answers by testing that the answer matches letter by letter,
  490. and case is important. In other words "BILL" would not match with "Bill".
  491.  
  492. EXACT NOCASE is the same as EXACT, except case does not matter. In the
  493. EXACT NOCASE instance, "BILL" and "Bill" would be a match.
  494.  
  495. Exact nocase is recommended for use in a multiple choice question, where the
  496. list of answers is by letters such as
  497.  
  498. a. Washington
  499. b. Jefferson
  500. etc
  501.  
  502. SOUNDEX is like EXACT NOCASE, except slight misspellings will not cause a
  503. mismatch. For instance SMITH will match with SMYTH or SMYTHE.
  504.  
  505. .pau (*Please press Enter*)
  506. .cls
  507. .col 12
  508.                                     DECIMAL
  509. .col 3
  510.  
  511. DECIMAL indicates that the answer is a decimal number, that is a number of
  512. the type 10 or 10.1 or 101.345. An answer of the type 1 3/4 would NOT be a
  513. decimal number.
  514. .col 12
  515.  
  516.                                       LIST
  517. .col 3
  518. LIST allows the designated answer to be a list of words, separated by commas,
  519. such as wheat, barley, oats. Case is not checked. The list may be in any
  520. order since "barley,wheat,oats will match "oats,Barley, WHEAT".
  521.  
  522.  
  523. .col 12
  524.                              FORCE and FORCE NOCASE
  525. .col 3
  526. FORCE indicates that the user will be forced to enter the designated answer.
  527. Any character which does not match the answer will be not be printed on the
  528. screen, and a beep will indicate that the character is not a part of the
  529. answer. FORCE checks for case, and FORCE NOCASE ignores case.
  530.  
  531. .pau (*Please press ENTER*)
  532. @beg
  533. @tries 4
  534. .cls
  535. Let's say you have created the question:
  536. .col 12
  537.  
  538. Who was the first president of the United States:
  539.  
  540. a. Benjamin Franklin
  541. b. Johnny Carson
  542. c. George Washington
  543. d. Francis Asbury
  544.  
  545. Please enter your answer:
  546.  
  547. .col 3
  548. What kind of answer type would you designate?
  549.  
  550. a. KEYWORD
  551. b. SOUNDEX
  552. c. EXACT
  553. d. EXACT NOCASE
  554.  
  555. @READ(*Please enter your answer:*)
  556. @RIGHT(*d*) EXACT NOCASE
  557. .play (*o2mbl16cdefgabo3c*)
  558.  
  559. That is correct since you want the answer to be exact, but case does not
  560. matter.
  561.  
  562. @wrong
  563.  
  564. No. Remember, you want the answer to match a, b, c, or d, (or A, B, C, or D).
  565.  
  566. .pau (*Please press ENTER*)
  567. @End
  568. .pau (*Please press ENTER*)
  569. @beg
  570. @tries 4
  571. .cls
  572. Suppose you enter the question:
  573.  
  574. .col 12
  575. Enter the name of the first president of the USA :
  576. .col 3
  577. What kind of answer type would you designate
  578.  
  579. a. KEYWORD
  580. b. SOUNDEX
  581. c. EXACT
  582. d. EXACT NOCASE
  583.  
  584. @READ(*Please enter your answer:*)
  585. @RIGHT(*a*) exact nocase
  586. .play (*o2mbl16cdefgabo3c*)
  587.  
  588. Correct, since you want the word WASHINGTON to be the keyword on which to
  589. match, and you will allow for various answers such as GEORGE WASHINGTON
  590. and G. WASHINGTON
  591.  
  592. @WRONG (*b*) exact nocase
  593.  
  594. Could be right, but let's assume you want them to spell the answer correctly.
  595.  
  596. .pau (*Please press ENTER*)
  597. @wrong
  598.  
  599. No, you want the word WASHINGTON to be the keyword on which to match, and you
  600. will allow for various answers such as GEORGE WASHINGTON and G. WASHINGTON
  601.  
  602. .pau (*Please press ENTER*)
  603. @END
  604. .pau (*Please press ENTER*)
  605. .cls
  606. .col 12
  607.                               SUMMARY INFORMATION
  608. .col 3
  609.  
  610. 1. The most common match used is KEYWORD, with the next being EXACT NOCASE.
  611.  
  612. 2. If you use LIST, make sure the question is worded so that the user knows
  613. that the answer must contain a list with commas separating each item.
  614.  
  615. 3. SOUNDEX checks for words that "sound" correct.
  616.  
  617. 4. When you use decimal, word the question so that an answer of the type
  618. 3 3/4 is not given instead of 3.75.
  619.  
  620. 5. The FORCE match is not supported in the CREATE program since it supports
  621. the concept of RIGHT, but does not allow a wrong answer. It may be added to a
  622. tutorial using the PC-CAI editor.
  623.  
  624.  
  625. .pau (*Please press ENTER*)
  626. .cls
  627. .color 12
  628.                                      REVIEW
  629. .color 3
  630.  
  631.  
  632. The PC-CAI system consists of several "modules".  They are
  633.  
  634. CREATE ....Helps you create tutorials
  635.  
  636. CAI .......Runs tutorials
  637.  
  638. CAIEDIT ...Contains an editor to allow you to create or edit tutorial files.
  639.            (Press CTRL-G in while the editor to run a tutorial.)
  640.  
  641. CAI-UTIL ..Contains support routines, including the IMAGE routine that allows
  642.            you to draw pictures for use in graphics or animation.
  643.  
  644. Please Refer to the PC-CAI manual for further information.
  645.  
  646. .locate 24,1
  647. .pause
  648. @LABEL:THATSALL
  649. .cls
  650. Thanks for coming by!
  651. .locate 24,1
  652. .pause
  653.